home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / Newton / Apps / Convert 2.5.sit / Convert! 2.5 Documentation.rsrc / TEXT_128.txt < prev    next >
Encoding:
Text File  |  1994-06-15  |  9.2 KB  |  287 lines

  1.  
  2.                     Convert! for the Newton Messagepad v 2.5
  3.  
  4.  
  5.  
  6.  
  7. Introduction
  8. Just as Newton is a replacement for your diary, Convert! is a replacement for the conversion tables usually found at the front. The interactive nature of Newton‚Äôs built-in metric converter initially struck me as being very useful. I was however frustrated by its limited scope and use of US measures, hence Convert! was born. 
  9. Convert! is my gift to the Newton community and is FREE to give away. That means that you may make use of the software and distribute it to any other user along with this documentation. Any comments are welcome, please send them to the address below.
  10.  
  11. Installation
  12. The Convert! package can be transferred to Newton via Apple‚Äôs Connection Kit or the Newton Package Downloader (which is available free from most good on-line services). If you are upgrading from Convert 1.x or 2.0 you will need to remove the old version manually. The installation of Convert 2.5 will automatically remove the old version's soups if they still exist.
  13.  
  14. General Operation
  15. Convert! allows the user to enter and quickly convert between 133 common (and not so common) metric and imperial units. Convert!'s menu screen is pictured below.
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48. Tapping on the appropriate icon in the menu screen opens its corresponding conversion table (the area table is pictured below). Once a value has been written into a field Convert! automatically calculates the corresponding values for the other units in the table. You can then simply overwrite any field with a new value and have the whole table recalculate.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78. Customizing the operating environment
  79. The following operating parameters can be specified via the prefs button in the main menu area. 
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99. Automatically open in: specifies which area Convert should open when launched.
  100. Results to: specifies the accuracy of the results displayed by Convert!
  101. Number entry font: defines the font used in the number fields.
  102. Number entry behaviour: defines whether the entry of a number in a field replaces or appends what is already there.
  103. Measurement system: Specifies the default volume measure to use.
  104. remove prefs: deletes Convert's data soup from Newton.
  105.  
  106. Conversions
  107. The following conversions are supported by Convert! v2.5 
  108.  
  109. Area
  110. sq. millimetres, sq. centimetres, sq. metres, ares, hectares, sq kilometres, sq inches, sq. feet, sq yards, sq rods, acres, sq miles.
  111.  
  112. Length
  113. millimetres, centimetres, metres, kilometres, inches, feet, yards, chains, fathoms, furlongs, cables, statute miles, nautical miles.
  114.  
  115. Volume
  116. cubic centimetres, litres, cubic metres, cubic feet, cubic yards, US and UK fluid ounces, US and UK pints, US and UK quarts, US and UK gallons, teaspoons, tablespoons, cups.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. The user may toggle between US and UK volume measures using the radio button pictured above.
  135.  
  136. Mass
  137. carats, milligrams, grams, kilograms, tonnes, ounces, pounds, stones, hundredweight (cwt), slugs, tons, long tons.
  138.  
  139. Pressure
  140. atmospheres, pascals, Newtons/sq metre, Kilopascals, bar, dynes/sq metre, mm Hg, torr, inches of water, ounces/ sq inch, pounds/ sq inch.
  141.  
  142. Temperature
  143. degrees centigrade, degrees fahrenheit, Kelvin, degrees rankine
  144.  
  145. Energy
  146. eVolts,MeV, ergs, joules, kilojoules, foot pounds, calories, kilocalories, kilowatt hours, british thermal units (BTU), tons of TNT
  147.  
  148. Time
  149. nanoseconds, microseconds, milliseconds, seconds, minutes, hours, days, weeks, years
  150.  
  151. Power
  152. watts, kilowatts, foot pounds/second, horsepower.
  153.  
  154. Velocity
  155. centimetres per second, metres per second, kilometres per second, kilometres per hour, inches per second, feet per second, miles per second, miles per minute, miles per hour, knots, speed of sound (Mach), speed of light (C).
  156.  
  157. Currency
  158. Conversion between five user defined currencies are supported. The default exchange settings shown below are used when Convert! is opened for the first time. 
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187. Any figure entered in the first five fields will be converted to the other currencies using the exchange rates in the lower half of the window. Exchange rates can be altered by overwriting the old value with the latest exchange figure. Convert will automatically save the new rate along with a date stamp of when it was altered. The date stamp can be viewed in the edit window below.
  188. Currency labels can be altered via the edit button and the corresponding window shown below.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209. Any alterations to the currency labels are saved.
  210.  
  211. Computing
  212. bits, kilobits, megabits, bytes, characters, kilobytes, megabytes, gigabytes, bits per second, seconds, inches, points, picas, ems.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220. In addition to the regular table calculations, the user can specify a data transfer constant (either in bits per second or seconds) via a radio button and have Convert! calculate the "missing variable". 
  221. For example to calculate how long it would take to transfer 2Mb at 2400bps: select the "bps" radio button and write in 2400 and 2 in the respective bps and megabyte fields. The answer will appear in the sec field.
  222.  
  223. Navigation
  224. radians, gradians, grades, degrees, minutes, seconds, quadrants, circles, signs
  225.  
  226. Unit measure conversions
  227. The length, mass, time, navigation and computing tables also have a button respectively labelled "yd:ft:in", "ton:lbs:ozs", "deg:min:sec" and "hr:min:sec". 
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235. This allows the user to additionally convert the feet, pounds and seconds fields from a fraction to whole units. e.g.: 6320 seconds = 1 hours, 45 minutes, 20 seconds. This field is also dragable.
  236.  
  237. Troubleshooting
  238. I cannot input a decimal number successfully: Remember there is a bit of a knack to entering data into Newton. I have found the most successful way to enter decimal numbers is to firstly never pause in the middle of a number (especially at the decimal point) and secondly place the decimal point close to the dotted base line. If the latter is not followed Newton has a tendency to change 456.78 into 456  .78 (and treat it as 456.00) or replace 456 with .78 (depending on which number entry behaviour setting is specified in the preferences. If the append number entry setting is in effect and Newton gets a digit wrong you can simply overwrite the digit with the correct one.
  239. Alternatively you can double tap on the field to bring up the number entry keypad.
  240.  
  241. Launching Convert! results in error 48404 (or similar): Convert's data soup is corrupt. Use a soup removal utility to remove the soup "convertdata:CLINT" and relaunch Convert!.
  242.  
  243. Error 48809 (or similar) when opening currency window: Convert's data soup is corrupt or has been deleted via the prefs window. Quit Convert and relaunch.
  244.  
  245. Legal Bits
  246. Convert! may be freely distributed via on-line services, BBSs and user groups provided it is distributed with its documentation and not altered in ANY way.  Commercial, Shareware and CD-ROM services must obtain advance permission in writing from the author before distributing this product.  This version of Convert! for Newton is free of charge.  However, it is NOT public domain.  All copyright, ownership and rights of ownership shall remain with the author.
  247.  
  248. All attempts have been made to ensure the accuracy of the numbers generated by this program. In no event shall the author be responsible for any consequential, incidental or indirect damages (including loss of business profits, business interruption, loss of business information and the like) incurred through the use of this software.
  249.  
  250. Change History
  251. Convert 1.0 : initial release.
  252. Convert 1.01: maintenance release
  253. Convert  2.0 beta : beta release (not for general distribution)
  254. Convert 2.0 : general release. Complete rewrite of Convert, better use of memory, user prefs, 62 more conversions... you get the idea.
  255. Convert 2.5 : general release. Provides Messagepad 110 compatibility. Addition of Navigation conversions and 14 other misc conversions. Addition of currency conversions. Provides user with greater flexibility over Convert's environment. New documentation.
  256.  
  257. Finally...
  258. I hope you find Convert! useful. Please don't hesitate to contact me with comments, suggestions and bug reports. If you include your contact details I will keep you informed with upcoming products (including new versions of Convert!). 
  259. If you have an uncontrollable urge to shower me with gifts I will humbly accept those as well.
  260.  
  261. The core functionality of Newton is useful, however I feel the device will become truly indispensable when it is coupled with custom applications tailored to your specific needs. If you are interested in tailored Newton applications don‚Äôt hesitate to contact me.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                                                             Clinton Logan
  277.                                                      Insight Solutions Group
  278.                                                              PO Box 4362
  279.                                                              Christchurch
  280.                                                              New Zealand
  281.                                   Internet Email: clinton@cosc.canterbury.ac.nz
  282.  
  283. About the author: Clinton Logan is a computer consultant currently based in Auckland, New Zealand. He specializes in Macintosh support and development and has recently been absorbed with Newton hacking. Guess what he prefers.
  284. He can be contacted via the above address or on his mobile  # 025 735 011
  285.  
  286.  
  287.